package com.example.demo.dao;

import com.example.demo.entity.pojo.AgentConversation;
import org.apache.ibatis.annotations.Param;
import java.util.List;

/**
 * Agent对话会话表(AgentConversation)表数据库访问层
 *
 * @author makejava
 * @since 2025-07-13 18:30:30
 */
public interface AgentConversationDao {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    AgentConversation queryById(Integer id);

    /**
     * 根据会话ID查询
     *
     * @param sessionId 会话唯一标识
     * @return 实例对象
     */
    AgentConversation queryBySessionId(@Param("sessionId") String sessionId);

    /**
     * 查询用户的会话列表
     *
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 会话列表
     */
    List<AgentConversation> queryByUserId(@Param("userId") String userId, @Param("limit") Integer limit);

    /**
     * 查询用户与特定Agent的会话列表
     *
     * @param userId 用户ID
     * @param agentId Agent ID
     * @param limit 限制数量
     * @return 会话列表
     */
    List<AgentConversation> queryByUserAndAgent(@Param("userId") String userId, 
                                               @Param("agentId") Integer agentId, 
                                               @Param("limit") Integer limit);

    /**
     * 查询Agent的所有会话
     *
     * @param agentId Agent ID
     * @param limit 限制数量
     * @return 会话列表
     */
    List<AgentConversation> queryByAgentId(@Param("agentId") Integer agentId, @Param("limit") Integer limit);

    /**
     * 查询活跃会话
     *
     * @param userId 用户ID
     * @return 会话列表
     */
    List<AgentConversation> queryActiveConversations(@Param("userId") String userId);

    /**
     * 新增数据
     *
     * @param agentConversation 实例对象
     * @return 影响行数
     */
    int insert(AgentConversation agentConversation);

    /**
     * 修改数据
     *
     * @param agentConversation 实例对象
     * @return 影响行数
     */
    int update(AgentConversation agentConversation);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 影响行数
     */
    int deleteById(Integer id);

    /**
     * 结束会话（更新状态）
     *
     * @param sessionId 会话ID
     * @return 影响行数
     */
    int endConversation(@Param("sessionId") String sessionId);

    /**
     * 统计用户会话数量
     *
     * @param userId 用户ID
     * @return 会话数量
     */
    long countByUserId(@Param("userId") String userId);

    /**
     * 统计Agent会话数量
     *
     * @param agentId Agent ID
     * @return 会话数量
     */
    long countByAgentId(@Param("agentId") Integer agentId);
}
